home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / winprogs / wlprs40a / wlprspl.asc < prev    next >
Encoding:
Text File  |  1994-07-06  |  29.8 KB  |  737 lines
  1.              Windows LPR Spooler Version 4.0a
  2.                              
  3.                              
  4.                  A Network Printer Spooler
  5.                  for Microsoft Windows 3.1
  6.                              
  7.                              
  8.                        July 6, 1994
  9.                              
  10.                              
  11.                              
  12.                              
  13.                              
  14.                              
  15.                              
  16.                              
  17. This  document  was  created  with  Microsoft  Word  for  Windows
  18. 2.0
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25. DISCLAIMER:
  26.  
  27. THE   SOFTWARE  IS  PROVIDED  AS-IS.  THE  AUTHOR  DISCLAIMS  ALL
  28. WARRANTIES,  EITHER  EXPRESS  OR  IMPLIED,  INCLUDING   BUT   NOT
  29. LIMITED  TO  IMPLIED  WARRANTIES OF  MERCHANTABILITY  OR  FITNESS
  30. FOR   A   PARTICULAR  PURPOSE.  NO  LIABILITY  IS   ASSUMED   FOR
  31. DAMAGES,  DIRECT  OR  CONSEQUENTIAL, WHICH MAY  RESULT  FROM  THE
  32. USE OF THIS SOFTWARE.
  33.  
  34. (C) Copyright 1992-94 by Thomas Heil.
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45. All  trademarks  appearing  in this  document  are  the  property
  46. of their respective owners.
  47.  
  48.  
  49. Table of Contents
  50.  
  51. Table of Contents                                         3
  52. Introduction                                              5
  53. New Features                                              5
  54. Requirements                                              5
  55. Package Contents                                          6
  56. Installation                                              6
  57. If you upgrade ...                                        7
  58. How Does the Spooler Work?                                8
  59. First Start                                               8
  60. Adding/Changing Network Printer Definitions               9
  61. Adjusting WLPRSPL Operating Parameters                   10
  62. WLPRSPL Running ...                                      11
  63. WLPRSPL Menu Options                                     12
  64. Usage Notes                                              14
  65. Troubleshooting                                          14
  66. Change Log                                               14
  67. Licensing and Registration                               16
  68.     Registration Fee                                       16
  69. One Final Word ...                                       17
  70. Registration Form                                        19
  71.  
  72.  
  73. Introduction
  74.  
  75. Windows  LPR Spooler, in the following text abbreviated  as
  76. WLPRSPL,  is  a  program which allows transparent  printing
  77. from   Microsoft  Windows  3.1  applications   to   network
  78. printers.  WLPRSPL allows you to define a large  number  of
  79. remote  printers  which may be addressed through  different
  80. Protocol DLLs.
  81.  
  82. Included with the program is WLPR2.DLL which implements the
  83. Line  Printer Daemon (LPD, RFC1179) protocol that is widely
  84. used  on  UNIX  hosts.  DLL's that  support  other  network
  85. printing  protocols  will  be developped  over  time.  (For
  86. details  on  which  Protocol DLLs currently  exist,  please
  87. contact  the author. Note: Protocol DLLs other  than  those
  88. included  in  the  shareware version will be  available  to
  89. registered users only.)
  90.  
  91.  
  92. New Features
  93.  
  94. Version 4.0a offers the following new features:
  95.  
  96.    Support  of  the new WLPR2.DLL API which allows  WLPRSPL
  97.    to  use  different  Protocol DLLs  for different  remote
  98.    printer   queues  (like  the  included  WLPR2.DLL   that
  99.    implements the LPR/LPD protocol).
  100.    The  spooler  can run in a so-called "unattended  mode".
  101.    In  this  mode the spooler automatically retries  failed
  102.    print  file transfers after a user-definable  amount  of
  103.    time.  The  user is not interactively notified  of  such
  104.    failures.  Spool failures are displayed in the  relevant
  105.    queue line of the spooler window.
  106.  
  107.  
  108. Requirements
  109.  
  110. The following components are required to run WLPRSPL:
  111.  
  112.    Microsoft Windows 3.1
  113.    WLPR2.DLL or compatible Protocol DLL(s).
  114.  
  115. If   the   spooler  is  used  together  with  the  included
  116. WLPR2.DLL,   the   following  additional   components   are
  117. required:
  118.  
  119.    TCP/IP  networking software for the  PC  that  offers  a
  120.    WinSock 1.1 compliant WINSOCK.DLL.
  121.    WSOCKAID.DLL  Version 1.0 or later.  Users  that  run  a
  122.    TCP/IP  stack other than FTP Software's should note  the
  123.    comment in the "Installation" section below.
  124.  
  125.  
  126. Package Contents
  127.  
  128. This  package  contains the spooler (WLPRSPL.EXE)  and  the
  129. supporting  libraries WLPR2.DLL Version 2.0a,  WSOCKAID.DLL
  130. Version  2.0, and CTL3D.DLL Version 2.05, as well  as  this
  131. documentation  in  form of a PostScript file  and  a  plain
  132. ASCII version.
  133. The   following   files  are  included  in   the   standard
  134. distribution:
  135.  
  136. WLPRSPL.EXE        The main program.
  137. WLPRSPL.PS/.ASC    Program documentation.
  138. WLPR2.DLL          The  Protocol  DLL  which  supports  the
  139.                    LPR/LPD protocol.
  140. WLPR2.PS/.ASC      The documentation for WLPR2.DLL.
  141. WSOCKAID.DLL       A    supporting   DLL   that    contains
  142.                    functions missing in WINSOCK.DLL.
  143. WSOCKAID.PS/.ASC   The documentation for WSOCKAID.DLL.
  144. WSAIDCNF.CPL       A  Control  Panel extension that  allows
  145.                    the    setting   of  the  username   for
  146.                    WSOCKAID.DLL.
  147. CTL3D.DLL          A  DLL that allows dialog boxes to  have
  148.                    a 3D look.
  149. CTRLD10B.ZIP       An   archive  that  contains   a   small
  150.                    utility     with    which    one     can
  151.                    enable/disable  the  generation   of   a
  152.                    leading   Ctrld-D  for   any   installed
  153.                    PostScript printer driver.
  154.  
  155.  
  156. Installation
  157.  
  158. Choose  a  directory where you want to install WLPRSPL  and
  159. create  it. Move the archive WLPRSnnn.ZIP to this directory
  160. and   unzip   it   with  PKUNZIP  2.04g  or  a   compatible
  161. uncompression program. Move all W*.DLL files to the Windows
  162. directory or to another directory that is in your PATH,  or
  163. include the directory where you installed WLPRSPL into your
  164. PATH. Copy CTL3D.DLL to your WINDOWS/SYSTEM directory after
  165. checking  that  there is not already a newer version.  Then
  166. either  create  a  new Program Manager  group  or  open  an
  167. existing  one, and install WLPRSPL.EXE there (please  refer
  168. to  your  Windows documentation on how to do  this).  After
  169. that you can start the program for the first time. For your
  170. convenience  you should install the spooler  also  in  your
  171. AUTOSTART group so that it gets launched automatically when
  172. you start Windows.
  173.  
  174. A  note  about  WSOCKAID.DLL: This is  a  network  software
  175. vendor  specific  DLL  containing  a  few  functions   that
  176. WINSOCK.DLL does not offer. Currently you will not get this
  177. DLL  from your vendor. The version in this pack was written
  178. by  us  explicitly  for FTP Software's  PC/TCP  stack.  The
  179. function  that  WLPRSPL  (or  better  WLPR2.DLL)  uses   is
  180. retrieving  the  user's  login  name.  If  you   have   FTP
  181. Software's  PC/TCP 2.1 or higher, this DLL  will  take  the
  182. needed  information from the PCTCP.INI  file  (or  whatever
  183. your  PCTCP environment variable is set to). If you  use  a
  184. different  stack,  you  may  copy  WSAIDCNF.CPL   to   your
  185. WINDOWS/SYSTEM directory. This small applet then allows you
  186. to set the username in the Control Panel.
  187. Note  that  the username is the only thing which  WLPR2.DLL
  188. retrieves  from  WSOCKAID.DLL. All other  information  that
  189. WSOCKAID.DLL can give (as described in WSOCKAID.ASC or .PS)
  190. is  ignored. The local PC hostname for example is retrieved
  191. from    the    networking   software   directly    (through
  192. WINSOCK.DLL),  which  means that you  have  to  have  a  PC
  193. hostname  configured in your networking software.  Protocol
  194. DLLs other than WLPR2.DLL may behave differently. Refer  to
  195. the corresponding DLL documentation.
  196.  
  197. If  you  use  a  TCP/IP stack that offers  a  real  Windows
  198. network  driver,  then WSOCKAID.DLL tries  to  inquire  the
  199. username through this driver instead of returning  the  INI
  200. file  entry.  You can verify if your TCP/IP  software  uses
  201. such a driver by looking at SYSTEM.INI section [boot]. If a
  202. non-empty  entry  "network.drv=<drivername>"  exists,  then
  203. your networking software has such a driver.
  204.  
  205. For  further  details concerning the included  DLLs  please
  206. take a look at the corresponding .ASC or .PS files.
  207.  
  208.  
  209. If you upgrade ...
  210.  
  211. If  you  upgrade  from Version 3.x to  4.0a,  WLPRSPL  will
  212. recognize  this the first time you start the  new  version.
  213. You  will  be  prompted if the settings of the old  version
  214. shall be retained. If you accept this, you will further  be
  215. prompted  if  the  old  Queue  Definition  File  shall   be
  216. converted  to  the  new format (which now  is  in  standard
  217. Windows .INI format).
  218.  
  219. The  old  Queue Definition File must be writable  when  you
  220. choose  to update it automatically. So if you have a shared
  221. QDF on a network drive you should start the new version  on
  222. a  PC  with  write access to this file first. It then  gets
  223. converted, and on all other PCs you can skip the conversion
  224. when WLPRSPL 4.0a is started for the first time there.
  225.  
  226. You   can   later   load   3.x    style   QDFs   with   the
  227. Setup/Queues/Load  queue definitions...  menu  option.  The
  228. program automatically determines that the file is not a 4.0
  229. QDF  and  asks if the file shall be read as 3.x QDF.  After
  230. the file is read you can save it as 4.0 file.
  231.  
  232. Note  that  the  spooler settings are  no  longer  kept  in
  233. WIN.INI but in WLPRSPL.INI in the Windows directory.
  234.  
  235.  
  236. How Does the Spooler Work?
  237.  
  238. Every  printer used within Windows is connected  to  a  so-
  239. called "port." Examples are LPT1, LPT2, COM1, COM2 etc. But
  240. those ports can also be normal disk files. When you add the
  241. line
  242.    
  243.    C:\SPOOL\DRUCKER.DAT=
  244.    
  245. to  the [ports] section of WIN.INI you may later connect  a
  246. printer driver to this "port." Every print job sent to this
  247. port is written to the specified file. This is what WLPRSPL
  248. relies  on. WLPRSPL uses a dedicated directory on  the  PCs
  249. hard disk for spooling (i.e. C:\SPOOL). This directory  has
  250. to  be specified the first time you start the program.  For
  251. each  network  printer you want to print  to  you  have  to
  252. define a unique file name (i.e. HP.PCL for a HP LaserJet in
  253. PCL  mode).  This file name together with the chosen  spool
  254. directory forms the port (in this case C:\SPOOL\HP.PCL)  to
  255. which   an  appropriate  Windows  printer  driver  can   be
  256. connected. The filename without path represents  the  local
  257. queue.
  258.  
  259. A  remote  printer is defined by the local  queue  name  as
  260. described above, the remote printer name, the host name  of
  261. the  computer that acts as printer server, and the name  of
  262. the  Protocol DLL to be used for connecting to  the  remote
  263. printer. The definitions of all remote printers are kept in
  264. a  Queue Definition File (which will be abbreviated as  QDF
  265. from now on). When starting the spooler for the first time,
  266. you  have  to  specifiy the location of this file.  It  may
  267. either be located on a local drive, but it could also be on
  268. a  shared  network  drive where it is  maintained  by  some
  269. network printer administrator.
  270.  
  271. You  define  remote printers by filling in the  information
  272. described  above  into  the  queue  setup  dialog.  WLPRSPL
  273. automatically  creates the needed port in WIN.INI  so  that
  274. you  later  can install an appropriate printer  driver  for
  275. this remote queue.
  276.  
  277. When  you  print  to such a network driver from  a  windows
  278. application,   the   printer  data  is   written   to   the
  279. corresponding spool file. WLPRSPL then puts the  file  into
  280. its  own  queueing system and sends the data to the  remote
  281. printer.
  282.  
  283.  
  284. First Start
  285.  
  286. When  you  start  WLPRSPL for the first time  you  have  to
  287. specify the spool directory you want to use. In the  dialog
  288. that  appears you can also create new subdirectories.  Once
  289. you  have selected the spool directory, you have to  define
  290. the place where the QDF shall be located. It is possible to
  291. use  a shared QDF that resides on a network drive and which
  292. is maintained centrally. The file that you specify does not
  293. have  to exist at this time. It will be created as soon  as
  294. you define the first queue in WLPRSPL.
  295.  
  296. After  this  first time configuration you may define  local
  297. queues for all remote printers you want to utilize. This is
  298. described  in  the  next section. Then you  should  install
  299. appropriate  Windows  printer  drivers  for  your   network
  300. printers and connect them to the corresponding port.
  301.  
  302.  
  303. Adding/Changing Network Printer Definitions
  304.  
  305. In  order  to define network printers in WLPRSPL start  the
  306. program  if not yet running, restore the program window  if
  307. the  program  is  iconized,  and  select  the  menu  option
  308. Setup/Queues/Define  new queue... or  press  Alt-Insert.  A
  309. dialog  pops up where you can enter a new queue definition.
  310. The fields in this dialog have the following meaning:
  311.  
  312. Local Spool File:  Name of the spool file (without path)
  313.                    that shall be used for the local queue.
  314. Remote Queue Name: Name of the queue on the remote print
  315.                    server.
  316. Remote Host Name:  Internet host name or address of the
  317.                    remote print server.
  318. DLL to be used:    Specifies the Protocol DLL to be used
  319.                    for this remote printer. It may be
  320.                    either the name only (which lets
  321.                    WLPRSPL search for it in the standard
  322.                    search order) or a fully qualified path
  323.                    name. WLPR2.DLL is the default for new
  324.                    queues.
  325.  
  326. After  filling  in  all  fields you can  review/change  the
  327. options  that are in effect for this queue by pressing  the
  328. Queue  properties...  button. The  options  in  the  dialog
  329. popping  up depend on the specified Protocol DLL.  For  the
  330. meaning  of  those  options  please  refer  to  the   DLL's
  331. documentation.
  332. When  you press OK in the "Edit queue data" dialog,  a  new
  333. port  is  created if needed. Now you can go to the  Control
  334. Panel/Printer Setup, install a printer driver that  matches
  335. the  remote  printer, and connect it to  the  corresponding
  336. port. Take care that all printer characteristics you define
  337. match  the  remote  printer. Normally a datastream  from  a
  338. Windows  printer driver overrides settings  of  the  remote
  339. printer  defaults. If you select settings that  the  remote
  340. printer does not support it may hang.
  341.  
  342. If  you  want to change the definition of a remote printer,
  343. select  it  in the main window listbox and click  the  menu
  344. option  Setup/Queues/Edit queue data... or press Alt-Enter.
  345. You get the queue setup dialog box with the currently valid
  346. values filled in, ready to be altered.
  347. Changes to queues are not automatically saved. This has  to
  348. be done either through Setup/Queues/Save queue definitions,
  349. or  by  accepting  the automatic saving  when  WLPRSPL  (or
  350. Windows) is terminated.
  351.  
  352. After  installing the printer driver you may print  to  the
  353. remote queue from any Windows application.
  354.  
  355.  
  356. Adjusting WLPRSPL Operating Parameters
  357.  
  358. Through  the menu (Setup/Preferences...) you can get  to  a
  359. dialog  box  where  you can change the following  operating
  360. parameters of WLPRSPL.
  361.  
  362. Timer ticks in sec. This entry defines the time steps  used
  363. by  WLPRSPL to periodically check for possible spool files.
  364. It can be 0 which means that this feature is disabled. With
  365. this  feature enabled it is possible to create spool  files
  366. in  DOS  sessions and have them automatically entered  into
  367. the WLPRSPL queueing system (see Usage Notes).
  368. Default is 0.
  369. Spool  timeout in sec. Time in seconds during which a print
  370. job  should  be completed. If it takes longer the  user  is
  371. notified and may cancel the transfer.
  372. Default is 60.
  373. Warn   if  suspended  When  this  check  box  is  activated
  374. (default),  you  get a warning every time you  print  to  a
  375. remote   network  printer  if  the  spooler  is   currently
  376. suspended.
  377. Default is on.
  378. Unattended  mode  When  this check box  is  activated,  the
  379. spooler  is in "Unattended Mode". This means that the  user
  380. is  not  notified  of spooling errors. Instead  the  faulty
  381. queue is temporarily disabled, and is re-enabled after  the
  382. number of seconds specified.
  383. Default is on.
  384. Automatically re-enable queue after ... sec. If  unattended
  385. mode  is  on, this entry specifies after how long a  failed
  386. print file transfer is retried.
  387. Default is 300 seconds.
  388.  
  389. Normally you can leave the default values as they  are.  If
  390. you notice a performance degradation on slow PCs due to the
  391. spool  file polling set the Timer Ticks to a higher  value,
  392. or  set it to 0 if this feature is not needed. If you often
  393. print large documents or you only have a slow link to  your
  394. print server you may want to set the Spool timeout... to  a
  395. higher value.
  396.  
  397.  
  398. WLPRSPL Running ...
  399.  
  400. When  WLPRSPL is active you normally don't notice  anything
  401. of  its  existance  because the spooling  is  done  in  the
  402. background. The WLPRSPL main window always shows  you  what
  403. is  currently  going on. You see the following  information
  404. being displayed:
  405.  
  406.    the time the spooler was started
  407.    the  mode  in  which  Windows is  running  (Standard  or
  408.    Enhanced)
  409.    the current state of the spooler (suspended or active)
  410.    the  current  run  mode of the spooler ("unattended"  or
  411.    "interactive")
  412.    the currently used spool directory
  413.    the currently used Queue Definition File
  414.    a  listbox  displaying the states of  all  local  queues
  415.    (more detailed description below)
  416.    the  Windows  printer  driver  used  for  the  currently
  417.    selected (and therefore highlighted) queue
  418.  
  419. The  individual columns in the listbox have  the  following
  420. meaning:
  421.  
  422. Symbol  If blank the local queue is currently not connected
  423. to  a printer driver, if ">" it is connected, if "*" it  is
  424. connected and is currently selected as default printer.
  425. Red  "E" If present, it indicates that there was some spool
  426. error.  You can check this error with the Queues/Show  last
  427. error...   menu  option  and  remove  the  flag  with   the
  428. Queues/Clear error flag menu option.
  429. Loc.  Queue  Name  of the local queue  (and  of  the  spool
  430. file).
  431. Rem. Queue Name of the queue on remote print server.
  432. Host Name of remote print server.
  433. Spool tries
  434. unsucc./succ.  Number of print jobs sent  over  this  queue
  435. since  WLPRSPL  was started or since the  queue  statistics
  436. were reset, and number of times the current spool file in a
  437. queue failed to be sent.
  438. Files queued Number of unsent print jobs.
  439.  
  440. Permanently disabled queues (that means "disabled by user")
  441. are  shown  with  red  text. A temporarily  disabled  queue
  442. (disabled  because  of spool error in unattended  mode)  is
  443. shown  with yellow text. A queue that is active  sending  a
  444. print  job  is  shown  in  green, and  the  statistics  are
  445. replaced with a progress message.
  446.  
  447.  
  448. WLPRSPL Menu Options
  449.  
  450. Following is a list with all available menu options. On the
  451. right hand side the keyboard short cut is shown.
  452.  
  453. Files
  454.    Delete next spool file                         (Delete)
  455.        Delete next spool file in selected local queue.
  456.    Delete all spool files in queue           (Ctrl-Delete)
  457.        Delete all spool files in selected local queue.
  458.    Delete all spool files              (Shift-Ctrl-Delete)
  459.        Delete all spool files in all local queues.
  460.    Cancel spooling                                (Ctrl-C)
  461.        A currently running transfer is cancelled.
  462.    Suspend/Resume spooler                         (Ctrl-S)
  463.        The  spooler  is  suspended,  or  its  operation  is
  464.        resumed,  depending  on the  current  state  of  the
  465.        spooler.  When  the spooler is suspended,  no  print
  466.        jobs are transferred to remote printers.
  467.    Control Panel
  468.        Call the control panel.
  469.    Exit                                 (Ctrl-X or Alt-F4)
  470.        Exit WLPRSPL.
  471. Queues
  472.    Show remote queue status                       (Ctrl-Q)
  473.        Shows   the   state   of  the  remote   queue   that
  474.        corresponds   to   the  selected  local   queue   by
  475.        executing  an  LPQ request. The dialog  box  showing
  476.        the  remote queue status then allows refreshing  the
  477.        display  and  cancelling one or  more  remote  print
  478.        jobs.
  479.    Show jobs in local queue                       (Ctrl-L)
  480.        Opens  a  dialog box that shows all jobs  which  are
  481.        still  in  the  currently selected local  queue.  In
  482.        this  dialog box you have the possiblity of removing
  483.        jobs individually.
  484.    Enable/Disable queue  (Doubleclick on queue in listbox)
  485.        The selected local queue is enabled/disabled.
  486.    Scan queues immediately(Click right mouse button on WLPR
  487.    SPL symbol)
  488.        The  spool directory is scanned for new spool  files
  489.        immediately.
  490.    Retry to spool now
  491.        If  the  queue  is  in retry timeout  state  (yellow
  492.        text)  because an error occured when trying to  send
  493.        the   active   spool  file,  the   spooler   retries
  494.        immediately to send the file instead of waiting  for
  495.        the time to expire.
  496.    Show last error...                             (Ctrl-E)
  497.        A   message  describing  the  last  spool  error  is
  498.        displayed.
  499.    Clear error flag                               (Ctrl-F)
  500.        A   message  describing  the  last  spool  error  is
  501.        displayed.
  502.    Reset selected queue                           (Ctrl-R)
  503.        The  statistics  of  the selected  local  queue  are
  504.        reset.
  505.    Reset all queues                         (Shift-Ctrl-R)
  506.        The statistics of all local queues are reset.
  507. Setup
  508.    Preferences...
  509.        Activates   the   dialog  described  in   "Adjusting
  510.        WLPRSPL Operating Parameters"
  511.    Spool-Directory...
  512.        Activates  the  dialog for selection  of  the  spool
  513.        directory described in "First Start".
  514.    Queues >
  515.        Define new queue                       (Alt-Insert)
  516.            Activates  the dialog for defining a  new  queue
  517.            described  in  "Adding/Changing Network  Printer
  518.            Definitions".
  519.        Edit queue data                         (Alt-Enter)
  520.            Activates  the  dialog for  editing  queue  data
  521.            described  in  "Adding/Changing Network  Printer
  522.            Definitions".  The  dialog is  filled  with  the
  523.            data of the currently selected local queue.
  524.        Delete queue                           (Alt-Delete)
  525.            Deletes the currently selected local queue.
  526.        Reload queue definitions
  527.            Reloads   the   queue   definitions   from   the
  528.            currently active QDF.
  529.        Load queue definitions...
  530.            Activates  the  dialog  for  selecting   a   QDF
  531.            described in "First Start".
  532.        Save queue definitions
  533.            Saves changes made to a queue definition in  the
  534.            currently active QDF.
  535.        Save queue definitions as...
  536.            Saves  the current queue definitions  to  a  QDF
  537.            which  must  first be selected. If wanted,  this
  538.            new  QDF  can be made the currently active  QDF,
  539.            which  will  then be used the next time  WLPRSPL
  540.            starts.
  541.    Register Program...
  542.        Activates  the program registration dialog.  If  you
  543.        have  a pre-registered version of the program,  this
  544.        menu option is grayed.
  545.  
  546.  
  547.  
  548. Usage Notes
  549.  
  550.    When  the  spool  directory is changed after  the  first
  551.    installation, new ports are automatically generated  for
  552.    all  local queues in the [ports] section of WIN.INI. The
  553.    user  then  has to manually connect all printer  drivers
  554.    to   those  new  ports.  This  is  currently  not   done
  555.    automatically.
  556.    If  you have a DOS application that can print to a  file
  557.    in  addition to printing to a real LPTx or COMx, you can
  558.    use   WLPRSPL  to  spool  those  files.  Just  let   the
  559.    application print to the file that defines the port  for
  560.    the  desired  network  printer  (i.e.  C:\SPOOL\HP.PCL).
  561.    Then  there  are  two  possibilities  to  initiate   the
  562.    transfer: Either you have set the Timer Ticks to a  non-
  563.    zero  value. In this case you only have to wait for  the
  564.    specified number of seconds, and WLPRSPL puts  the  file
  565.    into  its  queueing  system. If you have  disabled  this
  566.    feature  you can also switch back to WLPRSPL  with  Alt-
  567.    Tab  and select Queues/Scan queues immediately from  the
  568.    menu  or click on the WLPRSPL icon with the right  mouse
  569.    button.
  570.    The  state  of all queues (enabled/disabled, number  and
  571.    names  of  spool files) is saved in the spool  directory
  572.    as  file filename.SPL, where filename corresponds to the
  573.    name of the QDF. When, for example, the name of the  QDF
  574.    is  WLPRSPL.QS, then the name of the queue state file is
  575.    WLPRSPL.SPL. This file should not be deleted because  it
  576.    is  needed to determine to which local queue any  unsent
  577.    spool files belong.
  578.    When  you  print  to  a remote queue that  automatically
  579.    detects  PostScript  files and you  get  the  PostScript
  580.    text  printed, this usually happens due to the fact that
  581.    the   Windows   PostScript  driver   prepends   the   PS
  582.    datastream   with  a  Ctrl-D  (0x04).   This   character
  583.    normally causes a locally attached PS printer to  reset,
  584.    but  it  also makes it impossible for network queues  to
  585.    recognize  the print data as PS file. Included  in  this
  586.    package  is  a  ZIP  archive called  CTRLD10B.ZIP  which
  587.    contains  a  small Windows utility that  allows  you  to
  588.    selectively enable or disable the Ctrl-D generation  for
  589.    all installed PS printers.
  590.  
  591.  
  592. Troubleshooting
  593.  
  594. If  you  have  problems  with the  spooler  that  can't  be
  595. resolved  through this document please take a look  at  the
  596. documentation of the supporting DLLs. There are given  some
  597. troubleshooting tips which are specific to those  DLLs.  If
  598. this fails, too, please feel free to contact us. But do not
  599. forget  to provide us with info about the program  version,
  600. your  operating  system, and your networking  software,  as
  601. well as info about what printer and printer server you  use
  602. (model, operating system etc.)
  603.  
  604.  
  605. Change Log
  606.  
  607. Version 4.0a:
  608.    Package includes WLPR2.DLL Version 2.0a.
  609.    The  logic  when  saving the state of a queue  (enabled,
  610.    disabled,  retry timeout) was changed. Now, if  a  queue
  611.    is  permanently  disabled, it will stay  in  this  state
  612.    when  you  close down the spooler and later restart  it.
  613.    Previously,  a disabled queue went into "Retry  timeout"
  614.    state when the spooler was restarted.
  615.    In  the "Edit Queue Data" dialog the "Local Spool  File"
  616.    name now is limited to 12 characters.
  617.    Long  queue and host names extended into the data  right
  618.    of  it  in  the  main  window list  box.  They  are  now
  619.    truncated in the display.
  620.    In  unattended  mode, the error code of a  failed  spool
  621.    attempt  is  now  kept  and can be  displayed  with  the
  622.    Queues/Show  last  error... menu  option.  If  an  error
  623.    occured,  this is also indicated with a red "E"  at  the
  624.    beginning  of  the relevant line in the  spooler's  main
  625.    window listbox.
  626.  
  627.  
  628. Licensing and Registration
  629.  
  630. This software is not free. It is shareware. You are granted
  631. the  right to test this software for a period of  30  days.
  632. After   this   you  have  to  register  the  product   (see
  633. registration form at the end of this document) and, if this
  634. applies to you, pay the required registration fee.
  635.  
  636. The  unregistered shareware version displays a message  box
  637. at the program start reminding you that the program has not
  638. yet been registered. When you register the program, you get
  639. a serial number and a corresponding key. Start the spooler,
  640. select the Setup/Register Program... menu option, and  type
  641. your  user information together with serial number and  key
  642. into the dialog box. Then press the OK button.
  643.  
  644. You  may redistribute this program to other persons as long
  645. as  you  keep the package complete with all the files  that
  646. are  listed  in the "Contents" section at the beginning  of
  647. this document.
  648. Registration Fee
  649.  
  650. Members  of educational/non-profit institutions  belong  to
  651. Category I, all others belong to Category II. Please  refer
  652. to  the following table for pricing according to the number
  653. of licenses.
  654.  
  655. Licenses  Cat.  I  Price  per License  Cat.  II  Price  per
  656. License
  657. 1-9 30 DM 60 DM
  658. 10 or more 25 DM 50 DM
  659. 20 or more 20 DM 40 DM
  660. 50 or more 15 DM 30 DM
  661. 100 or more 10 DM 20 DM
  662.  
  663. For Site/Company Licenses and upgrades please contact us.
  664.  
  665. If you want to pay in currency other than DM please contact
  666. us.  If you want to wire the amount please assure that  all
  667. fees are handled on your side.
  668.  
  669.  
  670. One Final Word ...
  671.  
  672. Tell  us  everything you like or dislike about this program
  673. in  order to let us make it better. Tell us about functions
  674. that  you  would like to see added. Tell us about  problems
  675. you have encountered.
  676.  
  677. You  can  reach  us  under the following  E-mail  addresses
  678. (first in the list preferred):
  679.  
  680.     th.heil@kfa-juelich.de
  681.     ich211@zam001.zam.kfa-juelich.de
  682.     ich211@djukfa11.bitnet
  683.     ich211@ich210.ich.kfa-juelich.de
  684.  
  685. or by ordinary mail as
  686.  
  687.     Software-Vertrieb Susanne Heil
  688.     Hindenburgstr. 50
  689.     41352 Korschenbroich
  690.     Germany
  691.  
  692. or by fax under +49 (0)2161 644337
  693.  
  694.  
  695. Registration Form
  696.  
  697. (Please  register WLPRSPL 4.0a when you decide  to  use  it
  698. beyond the trial period of 30 days.)
  699.  
  700.  
  701. Name:
  702. Institution:
  703. Department:
  704. Street:
  705. City/Town and
  706.  ZIP/Post Code:
  707. State:
  708. Country:
  709. Phone number:
  710. FAX number:
  711. E-Mail address:
  712. Customer Numberfrom a previous registration
  713.  
  714. I  would like to register _______ Windows LPR Spooler  4.0a
  715. licenses
  716.  
  717. for         an educational/no-profit institution.Total price:    DM
  718.             a commercial/for-profit institution. Total price:    DM
  719.  
  720. Payment:       Remittance      to:Bank:      Stadtsparkasse
  721. Korschenbroich, Germany
  722.                          Bank  Routing  Code:  310  512  40
  723. Account: 473017
  724.           included Cheque (in German currency)
  725.  
  726.  
  727.  
  728.           Date/Signature
  729.  
  730. Please mail this form (with a possible fee included) to
  731.  
  732.        Software-Vertrieb Susanne Heil
  733.        Hindenburgstr. 50
  734.        41352 Korschenbroich
  735.        Germany
  736.  
  737.